4.15.07.00 - Apigee 개발자 서비스 포털 출시 노트

Apigee Edge 문서입니다.
Apigee X 문서로 이동
정보

2015년 9월 8일 화요일에 비공개 클라우드용 Apigee Edge 개발자 서비스 포털의 분기별 버전이 출시되었습니다.

이전 제품 이름인 'Apigee Edge 온프레미스 개발자 서비스 포털' 또는 'OPDK'가 이제 '비공개 클라우드용 Apigee Edge 개발자 서비스 포털'로 변경되었습니다.

궁금한 점이 있으면 Apigee 고객 지원팀으로 이동하세요.

모든 Apigee Edge 출시 노트 목록은 Apigee 출시 노트를 참고하세요.

포털의 Apigee Edge 요구사항

이 포털 버전을 프라이빗 클라우드용 Edge 설치에 연결하는 경우 모든 SmartDocs 기능이 지원되도록 버전 4.15.07.00 이상에 연결해야 합니다. 자세한 내용은 4.15.07.00 - 프라이빗 클라우드용 Apigee Edge 출시 노트를 참고하세요.

새로운 기능

SmartDocs 정식 버전

SmartDocs가 베타 버전에서 정식 버전으로 전환됩니다. 업데이트 및 새로운 기능은 다음과 같습니다.

  • 맞춤 이름이 지정된 보안 객체 지원을 비롯하여 파일 또는 URL을 통한 가져오기를 비롯한 Swagger 2.0 지원
  • SmartDocs를 생성하는 템플릿의 시각적 디자인이 개선되었습니다.
  • Drupal의 콘텐츠 > SmartDocs 메뉴를 통해 사용할 수 있는 개발자 포털의 사용성 및 워크플로 개선사항
  • '맞춤 토큰' 인증이라고 했던 것을 이제 'API 키'라고 합니다.
  • 버전 수준에서 정의된 인증 '보안' 객체입니다.
  • 템플릿 수준에서 클라이언트 인증을 구성합니다. 새 버전은 더 이상 사전 구성된 SmartDocs 클라이언트 사용자 인증 정보를 재설정하지 않습니다.

기능에 관한 자세한 설명은 이 블로그 게시물을 참고하세요.

SmartDocs 문서는 SmartDocs를 사용하여 API 문서화를 참고하세요.

SmartDocs 업그레이드 절차

베타 기간 동안 이미 SmartDocs를 사용하고 있다면 정식 버전의 새로운 기능과 기능을 사용하려면 개발자 포털에서 SmartDocs를 업그레이드해야 합니다.

개발자 포털에 이미 게시된 SmartDocs 페이지는 계속 작동하지만 기존 페이지 또는 새 페이지의 변경사항을 수정하거나 게시하기 전에 업데이트 절차를 따라야 합니다.

개발자 포털 내에서 SmartDocs를 렌더링하고 게시할 수는 있지만, SmartDocs는 Apigee의 Edge API 관리 서비스 내에 있는 API 모델에서 생성됩니다. Edge에서 API 모델을 변경하면 모든 Pantheon 환경에서 동일하게 변경됩니다 (Pantheon 환경 전반에 개발자가 존재하는 방식과 유사).

SmartDocs 베타에서 정식 버전으로 업그레이드하기

  1. Pantheon의 dev 또는 test 환경에서 15.05.27 출시를 업데이트하고 테스트합니다.
  2. 기존에 사용하고 있는 기존 API 모델을 대체할 새 모델을 만듭니다.
    • Swagger 또는 WADL 문서를 가져오고 있다면 새 버전으로 다시 가져옵니다.
    • SmartDocs 모듈을 통해 API 모델을 유지 관리해 왔다면 SmartDocs JSON으로 내보낸 후 파일 첨부파일을 사용하여 새 모델로 가져옵니다.
  3. 모델 버전의 보안 속성을 설정합니다. 콘텐츠 > SmartDocs > 모델 페이지에서 보안 설정을 선택합니다.
  4. 모델 설정 페이지 (콘텐츠 > SmartDocs)에서 작업 열의 설정을 클릭하여 사전 구성된 인증을 확인합니다.
  5. CSS 및 JS 애셋의 v6을 사용하도록 맞춤 템플릿을 업데이트하고 authSchemes 및 apiSchema와 같은 새 객체 이름을 반영하도록 변경합니다. SmartDocs 템플릿을 업데이트하는 방법에 관한 자세한 내용은 SmartDocs를 사용하여 API 문서화를 참고하세요.
  6. 모델 수정사항을 다시 렌더링하고 게시합니다.
  7. 새 문서를 검증한 후 프로덕션 포털을 15.05.27 버전으로 업데이트합니다.

Edge Enterprise 고객이 업그레이드 프로세스에 관해 질문이나 우려사항이 있는 경우 marsh@apigee.com 및 cnovak@apigee.com으로 이메일을 보내주세요. 그 외의 경우 Apigee 커뮤니티를 사용하여 최선의 답변을 받으시기 바랍니다.

수정된 버그

다음은 이번 출시 버전에서 수정된 버그입니다.

문제 ID 설명
DEVSOL-487 관리자가 수익 창출에서 일 형식을 구성할 수 있어야 함
이제 수익 창출의 수익 창출 설정에서 유럽 및 미국 날짜 형식의 날짜 형식을 구성할 수 있습니다.
DEVSOL-584 첫 사용 시 경로 매개변수가 기억되지 않음
호출 시 경로 매개변수가 항상 기억되지 않았습니다.
DEVSOL-603 중복 요금제 페이지 형식이 잘못됨
기존 요금제와 중복되는 요금제를 구매할 때 표시되는 페이지의 형식이 사용자에게 잘 표시됩니다.
DEVSOL-709 SmartDocs: 빈 값으로 요청을 전송한 후 URL 템플릿 매개변수를 수정할 수 없음
메서드 문서에서 템플릿 매개변수를 삭제한 후 SmartDocs에서 요청을 전송하면 템플릿 매개변수를 수정할 수 없게 되는 문제를 수정합니다.
DEVSOL-723 SmartDocs 가져오기 실패 시 사용자 친화적인 메시지 표시
DEVSOL-1013 Dev Portal 사용자 이메일 주소 수정 가능
프로필 수정 페이지의 이메일 주소 입력란이 더 이상 사용 중지되지 않으며 개발자가 이메일 주소를 변경할 수 있습니다.
DEVSOL-1244 OPDK 출시에 환경 표시기 모듈을 사용 설정하지 않음
DEVSOL-1273 'DevConnect Mint'가 모듈 목록에 두 번 표시됨
'모듈' 아래에 'Dev Connect Mint'가 두 번 표시되었습니다. 이제 이 문제가 해결되었습니다.
DEVSOL-1313 Swagger 및 WADL 모두에 JSON/YAML 파일 또는 URL 가져오기 지원
이제 WADL 파일을 URL을 통해 가져오고 Swagger 파일을 업로드할 수 있습니다.
DEVSOL-1339 SmartDocs 관리 메뉴 위치 변경
이제 SmartDocs가 콘텐츠 메뉴 아래에 있고 SmartDocs 설정은 설정 관리 메뉴 아래에 있습니다.
DEVSOL-1340 GA로 전환 시 베타 삭제
DEVSOL-1390

__toString() 호출 문제를 해결하기 위해 PHP SDK Edge 라이브러리가 업데이트됨
다음과 같은 오류를 만드는 DeveloperRatePlan 객체에서 __toString()을 호출하는 문제를 해결하기 위해 PHP SDK Edge 라이브러리가 업데이트되었습니다.

심각한 오류: 221번 줄의 /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php에서 객체가 아닌 항목에 대한 구성원 함수 format() 호출

이 버그는 toString() 메서드를 호출하는 맞춤 코드가 있는 수익 창출 고객에게만 영향을 미칩니다.

DEVSOL-1398 사용자에게 메시지를 표시하지 않고 설치 시 가져온 SmartDocs Petstore 모델
이제 SmartDocs는 사이트 설치 중에 날씨 모델 대신 petstore swagger 예시 (http://petstore.swagger.io/v2/swagger.json)를 가져와 SmartDocs 사용에 관한 더 포괄적인 예시를 제공합니다.
DEVSOL-1407 개발자가 많으면 Cron이 실패함
Drupal cron을 실행할 때 개발자가 많으면 시간 초과 문제가 발생합니다. 이제 조직에 200명 이상의 사용자가 있는 경우 일괄 프로세스가 사용됩니다.
DEVSOL-1410 Dev Portal 설치 시 연결 오류가 표시되지 않음
문제 해결 문제를 최소화하기 위해 Edge 관리 연결이 작동하지 않을 때 설치 프로그램에 더 나은 오류 메시지를 추가했습니다.
DEVSOL-1422 Apigee 프로필에서 SMTP 구성 양식 삭제
설치 프로세스에서 더 이상 SMTP를 구성할지 묻지 않습니다. 대신 SMTP 모듈을 사용 설정하고 올바르게 구성하는 표준 Drupal 관행에 따라 설치가 완료된 후 구성할 수 있습니다.
DEVSOL-1427

애널리틱스 데이터를 변경할 수 있도록 Devconnect 개발자 앱 모듈에 후크 추가
이제 devconnect_developer_apps 모듈에서 다음과 같은 세 가지 새로운 후크를 제공합니다.

# hook_devconnect_developer_apps_analytics_chart_data_alter()

# hook_devconnect_developer_app_analytics_datapoints_params_alter()

# hook_devconnect_developer_app_analytics_datapoints_alter()

이를 통해 맞춤 모듈이 개발자 앱 분석 차트를 변경할 수 있습니다.

DEVSOL-1464 모델의 인증 설정을 저장할 때 발생하는 심각한 오류
이제 보안 스키마를 삭제할 때 연결된 템플릿 인증 스키마도 삭제해야 하는지 선택할 수 있는 체크박스가 표시됩니다.
DEVSOL-1470 'API' 메뉴 링크 및 해당 뷰 만들기
이제 Dev Portal SmartDocs에는 기본적으로 'API'라는 기본 메뉴에 렌더링된 SmartDocs 문서 링크가 제공되며, 이 링크는 게시된 메서드가 있는 모든 모델로 연결됩니다.
DEVSOL-1486 SmartDocs 호출이 사전 정의된 키로 인증할 수 있음
사전 제공된 API 키와 사용자가 제공한 API 키로 모두 인증을 사용 설정합니다.
DEVSOL-1499 SmartDocs 매개변수 설명에서 HTML 코드가 파싱되지 않음
이제 SmartDocs 매개변수 설명에서 HTML 코드가 파싱됩니다.
DEVSOL-1507 Add Method를 사용하여 API에 여러 개의 매개변수를 추가할 수 없음
이제 메서드를 수정할 때 SmartDocs API에 여러 개의 매개변수를 추가할 수 있습니다.
DEVSOL-1509 SmartDocs API의 '샘플' 필드를 수정할 방법이 표시되지 않음
이제 SmartDocs 페이지를 수정할 때 '본문 MIME 유형', '본문 문서', '본문 샘플'을 설정할 수 있습니다.
DEVSOL-1534 Content-type이 SmartDocs 출력에 채워지지 않음
이제 Content-type이 SmartDocs 메서드 페이지에 채워집니다.
DEVSOL-1554 수익 창출의 잘못된 날짜 비교
수익 창출이 사용 설정된 개발자 포털의 구매한 요금제 탭에서 향후 시작일이 있는 요금제의 '취소' 버튼이 표시되지 않았습니다.
DEVSOL-1556 이전 버전의 Drupal 모듈이 제공됨
media_youtube 및 features 모듈이 최신 버전으로 업데이트되었습니다.
DEVSOL-1558 PetStore 예시의 SmartDocs 메서드 페이지가 렌더링되지 않음
이제 새 설치에서 예시 SmartDocs PetStore 메서드가 올바르게 렌더링됩니다.
DEVSOL-1562 각 SmartDocs 모델의 뷰 생성
새 모델을 만들면 기본적으로 해당 모델에 대한 새 뷰가 생성됩니다.
DEVSOL-1565 SmartDocs 메서드 수정 시 심각한 오류가 발생함
SmartDocs 메서드를 수정할 때 오류가 발생하는 문제가 수정되었습니다.
DEVSOL-1567 상단 관리 메뉴에 '모델 추가'가 표시됨
'모델 추가' 메뉴 항목이 상단 관리 메뉴에 표시되는 문제를 수정했습니다.
DEVSOL-1576 API 문서 뷰에 표시 이름이 아닌 모델 이름이 표시됨
메뉴에서 'API'를 클릭할 때 표시되는 API 문서 페이지에 표시 이름 대신 모델의 내부 이름이 표시되었습니다. 출시 버전으로 업데이트하는 중에 이 보기를 변경한 경우 다음 단계에 따라 보기를 되돌려야 변경사항을 확인할 수 있습니다. # 관리자로 로그인합니다. # 구조 > 보기로 이동합니다. # 'SmartDocs 모델'의 '수정' 옆에 있는 드롭다운을 클릭하여 모든 작업을 확인합니다. # '되돌리기'가 표시되면 자체 변경사항으로 코드를 덮어썼음을 의미합니다. '되돌리기'를 클릭하여 뷰를 기본 상태로 되돌립니다. 이렇게 하면 이 보기에 적용한 모든 변경사항이 삭제됩니다.
DEVSOL-1578 사이트 설치 시 Weather 및 Petstore 모델 모두 렌더링
Petstore 및 Weather SmartDocs 모델이 모두 새 사이트에 가져옵니다.
DEVSOL-1584 요금제를 구매할 수 없음
Apigee 반응형 테마 또는 Apigee 반응형 테마의 하위 테마를 사용하는 경우 클라우드 출시 15.05.27.00 및 15.06.08.00에서 수익 창출 요금제 구매 양식이 제출되지 않는 문제를 수정했습니다.
DEVSOL-1597 개발자 시간 제한 설정을 변경할 수 없음
Edge 연결 시간 제한 설정이 제대로 적용되지 않는 버그가 수정되었습니다.
DEVSOL-1620

나, 환경 표시기, 기능 모듈 업그레이드
나 모듈의 보안 업데이트(중간 정도 중요도) 및 환경 표시기 및 기능의 모듈 업데이트 추가 정보:

https://www.drupal.org/project/me https://www.drupal.org/project/environment_indicator

https://www.drupal.org/project/features

DEVSOL-1648 reCAPTCHA 중단을 방지하기 위해 arg_separator.output이 '&'인지 확인
Google reCAPTCHA 사용이 중단되는 플랫폼 관련 문제가 수정되었습니다.
DEVSOL-1651 smartdocs 모듈이 사용 설정되지 않으면 Apigee Base 테마가 실패함
apigee_base 테마가 더 이상 SmartDocs 모듈의 사용 설정에 종속되지 않습니다.
DEVSOL-1654

중요한 보안 수정사항을 적용하도록 admin_views 버전 범프
다음 contrib 모듈이 업데이트되었습니다.

  • 관리 뷰
  • 마이그레이션
  • 리디렉션
  • Redis
  • 일괄 작업 보기